// 抽离公共代码块
/**
 * @apiDefine CommonSuccess 公共响应字段
 * @apiSuccess {Number} code The success res code.
 * @apiSuccess {String} msg The res message.
 */

/**
 * @apiDefine token 需要验证用户权限
 * 需要在header中加入token字段进行用户权限验证
 * @apiHeader {String} token 用户权限验证
 */

/**
 * @apiDefine none 不需要任何权限
 * permission定义成none，不需要任何权限就可访问接口
 */

/**
 * @apiDefine InvalidToken 权限认证失败
 * @apiError {401} InvalidToken 用户权限校验不通过
 * @apiErrorExample {json} Error-Response:
 * HTTP/1.1 401 Unauthorized
 * {
 *    "errcode": 401,
 *    "message": "Invalid Token"
 * }
 */

/**
 * @apiDefine base 接口域名
 */

/**
 * @api {get} /users 接口示例
 * @apiDescription 获取用户列表
 * @apiName GetUserList
 * @apiGroup Demo
 * @apiPermission token
 * @apiHeader {String} token 用户权限验证
 * @apiUse CommonSuccess
 * @apiSuccess {Array} data 响应数据
 * @apiSuccessExample {json} Success-Response:
 * HTTP/1.1 200 OK
 *  {
 *      "errcode" : 0,
 *      "message": "",
 *      "data" : [{
 *          "id": 0,
 *          "name" : "userName",
 *          "email" : "userEmail"
 *      }]
 *  }
 * @apiSampleRequest http://localhost:3333/users
 * @apiVersion 1.0.0
 */
